home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 101-125 / scopedisk121 / post1.1 / readme < prev    next >
Text File  |  1995-03-19  |  5KB  |  114 lines
  1. Postscript interpreter - README
  2. ===============================
  3.  
  4. Post V1.1 Copyright Adrian Aylward 1989, 1990
  5.  
  6. This distribution was released as the archive file "post11.lzh", 27-Mar-90
  7.  
  8. Files in this distribution:
  9.  
  10. README             This file
  11. Post.info          Icon file
  12. post               User interface
  13. post.doc           Documentation file
  14. postband           Band printing driver
  15. postband.doc       Documentation file
  16. post.library       Shared library for Amiga 500/1000/2000
  17. post.library.2620  Shared library for Amiga 2500 etc. (68020/030, 68881/2)
  18. init.ps            Standard postscript startup file
  19.  
  20. Source files, for programmers:
  21.  
  22. source/icon.ps     The postscript program that built the icon
  23. source/post.c      User interface, C main program
  24. source/postband.c  Band printing driver, C main program
  25. source/postasm.a   User interface, assembler support
  26. source/postlib.h   Library interface header
  27. source/postlib.doc Documentation file
  28. source/makefile    Make file
  29.  
  30. You will also need:
  31.  
  32. arp.library     Arp library, V39+
  33. conman          ConMan, V1.3+
  34.  
  35. You should find these on "All Good BBS's/disk libraries"
  36.  
  37. You will need at least a megabyte of memory.  Even with a megabyte you
  38. will have not be able to generate a full page colour on the screen.  For
  39. high density printer output (A4 at 300 dpi.) you will need 2 megabytes!
  40. If memory is very tight, try running from the CLI, before workbench has
  41. been loaded.
  42.  
  43. Before using Post you will need to copy the library (post.library or
  44. post.2620.library) into your libs: directory.
  45.  
  46. Examples
  47. ========
  48.  
  49. The examples and demo programs are now being distributed separately.  Look
  50. out for the file "psdemos1.lzh".  (If you have the prerelease "post02.lzh"
  51. there is no need to download them, as they have not changed significantly).
  52.  
  53. The startup file
  54. ================
  55.  
  56. The standard startup file "init.ps" should be run before most programs.  You
  57. should read it and the comments within it, as you may wish to customise it.
  58. It defines useful operators to mimic a standard PostScript printer.  It
  59. also handles automatic font downloading (see below).
  60.  
  61. Fonts
  62. =====
  63.  
  64. As there are no fonts built in to the interpreter, all fonts must be loaded
  65. from the disk, as PostScript source.  The standard startup file redefines
  66. the findfont operator to automatically load fonts from the disk the first
  67. time they are referenced.  To use this, build a directory "PSFonts:" 
  68. containing your PostScript fonts.  (NOT Amiga bitmapped fonts!).  The file
  69. names should be the same as the PostScript names, without the '/'.  You can
  70. add an extension if you wish, by editing the startup file.  You can also
  71. make it search more than one directory, for examples to load the PPage CG
  72. fonts from "CGFonts:PS".  The startup fil also defines a default font,
  73. which will be substituted if the font your program requests cannot be found.
  74.  
  75. Since a font is loaded into the vm just like any other PostScript code, it
  76. will be discarded when the vm is restored.  This means that in a multiple
  77. page document the fonts will likely be reloaded on every page.  To save time,
  78. it is usually much better to preload the fonts you are going to need.  You
  79. can do this using the "load font" menu command, or you can write yourself
  80. a little PostScript program to load your favourite fonts.  (Exercise for
  81. the user: write a driver to extract the font names from a conforming
  82. PostScript program and preload them.)  If you are using several different
  83. fonts at once you will probably need to increase the default vm size to
  84. contain them.
  85.  
  86. There are a number of commercial source for fonts.  Make sure they are
  87. standard (type 3) fonts.  The Adobe encrypted fonts (type 1) will not work
  88. with this version of Post.
  89.  
  90. There are also various shareware and PD fonts available.  Many of these were
  91. derived from the Mac or IBM.  They may still be in a foreign file format.
  92. The file should be converted to readable ASCII, with no strange control
  93. characters. Some of the fonts have Mac encoding vectors.  You won't notice
  94. the difference for the standard ASCII characters, as they are the
  95. same, but you may have to convert to the standard encoding to get
  96. more unusual characters like the trademark sign to work.  (Programs
  97. like Adobe illustrator do their own font encoding anyway.)  You
  98. will need to know some PostScript to make this change.  If you
  99. see the sequence "/Helvetica findfont /Encoding get" or
  100. "<dictionary> /MacVec get" try replacing it with "StandardEncoding".
  101.  
  102.     You are recommended to ensure all your fonts have UniqueID's.
  103. This makes the font caching code more efficient.  Often all you have
  104. to do is uncomment them in the source.  Any number will do for the
  105. ID (up to 2**24 - 1), as long as it is different for each of your
  106. fonts.  Make it a multiple of 4, as Adobe recommend adding 1 or 2
  107. to the ID when modifying the font.
  108.  
  109.     Each font should have a FontName entry.  This isn't actually
  110. required by Adobe, but certain programs such as Adobe Illustrator
  111. copy the font directory when recoding the font.  If the name is
  112. missing, you get a dictionary full error after the name has been
  113. added.
  114.